MCPaste(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Editing Movies

MCPaste
The MCPaste function inserts a specified movie at the current movie time in the movie associated with a specified controller.
pascal ComponentResult MCPaste (MovieController mc, 
                                 Movie srcMovie);
mc
Specifies the movie controller for the operation. You obtain this identifier from the Component Manager's OpenComponent or OpenDefaultComponent function, or from the NewMovieController function (described on page 2-28).
srcMovie
Specifies the movie to be inserted into the current selection in the movie associated with the movie controller specified by the mc parameter. If you set this parameter to nil, the movie controller component retrieves the source movie from the scrap.

DESCRIPTION
All of the tracks from the source movie are placed in the destination movie. If the duration of the destination movie's current selection is 0, the source movie is inserted at the starting time of the current selection. If the current selection duration is nonzero, the function clears the current selection and then inserts the tracks from the source movie. After the paste operation, the current selection time is set to the start of the tracks that were inserted and the duration is set to the source movie's duration.

SEE ALSO
This function is analogous to the Movie Toolbox's PasteMovieSelection function.

SPECIAL CONSIDERATIONS
The preferred way to use the MCPaste function is to set the srcMovie parameter to nil. This causes the movie controller to use movie import components to paste other types of data than movies.